home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 29 / applic / naviga.doc < prev    next >
Text File  |  1985-11-19  |  8KB  |  265 lines
  1.  
  2.                          Navigate! Instructions
  3.                         (Version One)   Page -1-
  4.  
  5.  
  6.  
  7. I: Introduction.
  8.  
  9.    I  wrote  Navigate!  for military flight-planning use. Realizing that
  10. other  navigators  or private pilots might find it useful, I've released
  11. it  for public use. However, I reserve all rights to Navigate! Navigate!
  12. was  written  in  Personal  Pascal  (copyright  OSS  &  CDD). I've found
  13. Personal  Pascal  an invaluable tool for GEM programming on the Atari ST
  14. computers and recommend it highly to budding programmers.
  15.  
  16.    How  much  time is invested in Navigate!? Well, I began in January of
  17. 1986. I had never programmed in Pascal before, so the entire project was
  18. undertaken  as a learning experience. Version One was completed in July,
  19. albeit in a somewhat incomplete form. All told then, it represents about
  20. six  months  worth  of  weekends  and weeknights (less one or two months
  21. spent  on other projects).  Revised versions of Navigate! will appear on
  22. national  BBSs  as  I  complete  each  version.  I  urge  users  who are
  23. programming-
  24. oriented  to  modify or add to Navigate! To this end I am also providing
  25. the Navigate! source code.
  26.  
  27.    I can be contacted (until March 1987) at:
  28.  
  29.                          Scott Stephenson
  30.                          955 S. Craycroft A16
  31.                          Tucson,  AZ 85711
  32.  
  33.                      or on Compuserve (73267,3560)
  34.  
  35.    In  March,  I'll be moving to Sembach AFB, Germany. Anyone wishing to
  36. correspond after that date should write to:
  37.  
  38.                          Scott Stephenson
  39.                          2943 Saltsman Rd
  40. II: Getting Started
  41.  
  42.       In present form, Navigate! requires:
  43.  
  44.         1. an Atari ST with TOS in ROM
  45.         2. a small (100K or so) ram disk (named D:)
  46.         3. the ICAO.DAT file (it must be on D:)
  47.         4. at least one flight plan (ex: A:sample.fp)
  48.         (saved on any drive)
  49.         5. the NAVIGATE.PRG file
  50.  
  51.       NAVIGATE! runs on monochrome or medium-resolution color systems.
  52.  
  53.       If  you  have  the  above,  simply  click  on  Navigate.prg to get
  54. started. The documentation below is sparse (what do you want with a free
  55. program!),  so  I  recommend  the  user  have  Navigate!  running as the
  56. document below is read.
  57.  
  58.    III: The FILE menu
  59.  
  60.    The  LOAD item allows the user to load a flight plan from any drive .
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                          Navigate! Instructions
  69.                         (Version One)   Page -2-
  70.  
  71.  
  72. You  MUST select an existing flight plan(to create a new plan, read on).
  73. The  SAVE  AS item lets the user save a flight plan from screen to disk.
  74. The user can replace an existing flight plan or type in a new name.
  75.  
  76.    The  DESTROY  item will clear the screen and the computer's memory of
  77. the  flight  plan  currently  in use. This allows the user to start from
  78. scratch, should he wish to create a flight plan from scratch.
  79.  
  80.    The  QUIT  item  terminates Navigate! An alert box will first ask the
  81. user  if  he/she  really wnats to quit. Upon quitting, Navigate does not
  82. save any flight plan on the screen or in use.
  83.  
  84.    The  PRINT  item  prints  the  flight  plan  on  the screen. Print is
  85. currently  customized  for  an Epson printer with a Dots Perfect upgrade
  86. kit. Epsons without the upgrade may give strange results.
  87.  
  88. IV: The EDIT menu
  89.  
  90.    The ADD ROW item does just that. It is used to add or replace any row
  91. on the screen with a new point. ADD ROW will prompt the user for various
  92. values.  The  most important of these is the ICAO field. The four letter
  93. identifier  input  causes  Navigate!  to  search  the  ICAO.DAT file for
  94. latitude  and longitude values. If Navigate! can't find these values, it
  95. prompts the user to input them via a data input box.
  96.  
  97.    The  DELETE  ROW  item  also  does  just  what  it says. It does some
  98. primitive  range  checks to ensure the user has entered a valid row, and
  99. then  it  just deletes the row in question. DELETE ROW works just like a
  100. word-processing delete function.
  101.  
  102.    The  INSERT ROW item inserts a blank row (if possible). The user must
  103. then input row values with ADD ROW.
  104.  
  105.    The  COPY ROW item copies a row from one location to another, leaving
  106. the  original  row  undisturbed.  It  works just like a spreadsheet copy
  107. function.
  108.  
  109.    The  WIND  CHANGE  item  lets the user changes the wind values of the
  110. flight plan currently in use. WIND CHANGE prompts the following values:
  111.  
  112.      1. Wind Direction & Velocity    (27/25 = 270 degrees at 25 knots)
  113.  
  114.      2. The starting and ending rows
  115.      for the wind change. (1 to 44)
  116.  
  117.    The  FUEL  CHANGE  item  allows the user to enter a fuel burn rate in
  118. terms  of  hundreds  of  pounds  per  hour.  FUEL CHANGE prompts for the
  119. following values:
  120.  
  121.      1. Fuel burn rate
  122.      (50 = five thousand pph)
  123.  
  124.      2. The starting and ending rows
  125.      for the fuel change. (1 to 44)
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                          Navigate! Instructions
  135.                         (Version One)   Page -3-
  136.  
  137.  
  138.    The  DATA  UPDATE  item  allows  the  user  to  enter values into the
  139. ICAO.DAT  file  for future use (Navigate! will force this function if it
  140. can't  find  a  point  added  by  the user). DATA UPDATE prompts for the
  141. following values:
  142.  
  143.      1. Name(If not passed by Navigate!)
  144.      (4  letters  only, may be any legible number    or character, upper
  145. or  lower  case,     Navigate  pays VERY close attention to    case when
  146. searching for a name)
  147.  
  148.      2. Latitude & longitude
  149.      (ex: N32100 = 32 degrees 10.0 minutes)
  150.      (ex: W110532 = 110 degrees 53.2 minutes)
  151.  
  152. Make sure that you save the file ICAO.DAT file from the ram disk to your
  153. disk  drive  when you quit NAVIGATE! Otherwise, any changes will be lost
  154. when  you  turn  off the computer. (You only need to do this if you have
  155. changed or added to ICAO.DAT while using NAVIGATE!).
  156.  
  157.    The  REDRAW item redraws the screen if for any reason it gets mangled
  158. or  overwritten  in any manner (I've never had this happen, but it never
  159. hurts to be prepared).
  160.  
  161. V: The OPTIONS menu
  162.  
  163.    The  SCREEN  2 item lets the user switch between the two data screens
  164. of NAVIGATE! This is necessary because NAVIGATE! can contain 44 lines of
  165. data, while the ST screen can only display 25 lines of data.
  166.    The  AUTO  CALC  item  is a toggle of NAVIGATE!'s calculator. It will
  167. normally  be left on. If the user for any reason(such as impatience with
  168. the  3 second calculate time) desires to turn off the calculator, he/she
  169. need only click this item. WARNING! AUTO CALC must be turned on in order
  170. for  calculation to occur! (exception: the printer utility automatically
  171. calculates  before  printing,  irregardless  of  the  AUTO  CALC  toggle
  172. setting)
  173.  
  174. VI: The FUEL menu
  175.  
  176.    The  FUEL  menu  hasn't yet been implemented. When completed, it will
  177. prepare an official fuel log and graph. VII: The ETP menu
  178.  
  179.    The ETP menu isn't implemented yet. It will calculate the "equal time
  180. point" (point of no return) for an overwater flight.
  181.  
  182. VIII: Caveats
  183.  
  184.    I  haven't  got  around  to  making NAVIGATE! very user friendly yet,
  185. though that's in the works. Also, error checking is incomplete. WARNING!
  186. NAVIGATE! will crash if you enter bad data! For this reason, I recommend
  187. saving your flight plans frequently.
  188. Some  functions may operate in ways that seem strange. Some buttons give
  189. no  result. These are all the common afflictions of a new program. Later
  190. versions will (I hope!) fix these bugs.
  191.  
  192.    Make  SURE  that  ICAO.DAT  is  on D:RamDisk or NAVIGATE! won't work.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                          Navigate! Instructions
  201.                         (Version One)   Page -4-
  202.  
  203.  
  204. NAVIGATE.PRG and the flight plan files (.FP) can be on ANY disk.
  205.  
  206.    Don't  deliberately  enter  bad data. This may sound odd to some, but
  207. there are folks out there who delight in tempting fate. NAVIGATE! reacts
  208. to bad data with rigor mortis.
  209.  
  210. By Scott D. Stephenson, July 1986... Revisions on the way!
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265. əəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəə